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Confidentiality 

All information contained in this document shall be kept in confidence. No part of this document is to be 
altered or copied without the written agreement of TransferTo Ltd. None of this information shall be 
divulged to persons other than to authorised employees of TransferTo Group or any of TransferTo Group 
subsidiaries, and shall be on a need to know basis. Release of this document to other parties shall be to 
individuals of organisations authorised by TransferTo and in accordance with existing policy regarding 
release of company information and shall only be made available when an acceptable NDA has been 
signed with that party. 

Please contact to support@transfer-to.com for your queries on documentation and products/services of 
TransferTo. 
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Glossary 


Acronym or Term 

Definition 

DTH 

Direct-To-Home 

MSISDN 

Mobile Subscriber Integrated Services Digital Network-Number 

PLN 

Perusahaan Listrik Negara, English: 'State Electricity Company 1 
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1.0 Company Profile 

TransferTo helps businesses offer airtime top-ups, goods and services, and mobile money around the 
world in real time. Our global airtime and mobile money Hub provides an essential combination of 
services and technology to mobile telecommunication companies and financial institutions including 
MTN, Singtel, Orange, Western Union, PayPal, and Xoom. 

Thousands of companies in over 100 countries depend on TransferTo to provide mobile financial 
transactions for their customers without the need for a bank account. TransferTo's clients are companies 
whose consumer base consists largely of people connecting with family and friends back home. Founded 
in 2005, TransferTo currently links +4.5 billion mobile users across more than 400 mobile operators. 


Mobile Money and Airtime Hub 



FINANCIAL 

INSTITUTIONS 


MOBILE 

MONEY 


MOtllC MON IV OPERATORS 


Real-Time Transactions 
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2.0 Getting Started: Account Set-Up and Management 

This API enables developers to integrate TransferTo Top-up service into their system. If you are building 
application that leverages international recharge services, then this is the API for you. 

Before started, you may want to explore what developers have done by integrating this API. Then, you 
should have a look at the URL listed in Annexes (Web and Mobile Apps Developers Samples, chapters 
10.4 and 10.5). 

This section introduces the following best practices related to account set-up and management: 

• Retrieve your account credentials 

• Send a request (HTTPS) 

• Establish a connection to the API 

• Generate a temporary and unique key to query the API 

• Consult and credit your account balance 

• Test your account 

2.1 Retrieve your API Token 

Once you have received your account credentials (login, password) to access the TransferTo web 
interface, you must log in and retrieve your API token to be used with the TransferTo API. 

To activate access to your API account, enable Two Factor Authentication (2FA). Google Authenticator 
app is available on iTunes and Google Play. We strongly recommend you the use of the Google 
Authenticator app over SMS Authentication as it is not time or network-dependent. If you do not have 
access to the Google Authenticator app, select SMS Token. 

To sign up to 2FA 

1. Login to http://shop.transferto.com/ . 

2. Select Developer from the top menu, and click Click Here to enable 2FA. 

3. Select Google Authenticator and click Save. 

4. In Google Authenticator app, scan the displayed barcode or direct key-in the displayed code. 
You are registered. 

Then, to retrieve your API token 

1. Select Developer from the bottom menu. 

2. Enter the 6 digits code displayed on your device's Google Authenticator. 

3. Click on Submit button. 

Your API token is displayed. 

Click on REGENERATE and Save if you need to reset it. 
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2.2 How to Send Requests 

TransferTo platform is reachable via HTTPS URL. 

There are currently 3 ways or methods to send a request to the API: 

• XML format (POST method) 

• Plain text (POST method) 

• Plain text (GET method) 

The platform will send a response formatted to XML if XML format was used in the request. 

Plain Text POST/GET Requests 

You must provide parameters using the HTTPS POST or GET methods (both are valid and recognized by 
the system). While GET method is good for writing test requests quickly, we recommend using POST 
method for production as there is no length limitation and is safer. 

The URL to reach the platform is https://airtime.transferto.com/cgi-bin/shop/topup 

A GET request will look like this one: 

https://airtime.transferto.com/cgi-bin/shop/topup?login=login&key=key&md5=md5&action=ping 

With the following parameters passed in the URL: 

• login 

• key 

• md5 

• action (here ping) 

For a POST request, the parameters are sent in the request body. 

If you send the parameters using the POST method or the GET method, the TransferTo API sends back a 
"text/plain" document with human readable information formatted in the following format (each line 
ends with '\r\n'): 

j valuel=resultl 
I value2=result2 


XML POST Request 

As discussed above, you can also reach the platform using XML. 

When sending a request, format content in XML before creating the URL request. 
Note: Set the content type to "text/xml " 


The response will be in XML. All field names that you used to create the request and received in the re¬ 
sponse remain the same as those used in "text/plain" format. 
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2.3 Authentication and Security 

In addition to HTTPS, an IPSEC VPN can be established upon request. 

In the XML message itself being transmitted over HTTPS, 3 parameters are related to authentication: log¬ 
in, key, MD5. 


Parameter 

Type 

Description 

login 

Alphanumeric String 

Account login name provided by TransferTo. 

key 

Integer 

Key generated by the client. The transaction is rejected if the 
key has been used. 

md5 

Alphanumeric String 

MD5 sum of the hex encoded concatenation of login, token, 
and key. 


Table 1 - Authentication parameters 


For each request, generate a key, which is a unique integer. Generate and manage this key on your side. 
To generate this key, you need to use your API token (alphanumeric string retrieve from the web inter¬ 
face as described in chapter 2.1). 

The following is an example of a good key. 

• Use a unique server: a time stamp with milliseconds. 

• Use multiple servers. 

Use a common sequence shared through a database to ensure that all the servers 
are synchronized. 

Set up several accounts through the Transfer-To web interface to have distinct se¬ 
quences (one per server for instance). 


Note: As of 31st July 2013 (API version 1.06.18), access to the API is fully independent from your ac¬ 
count's credentials. A separate token must be activated to connect to the TransferTo API. For existing 
users prior to 31st July 2013, your token is the same as your account's password. 


Example 

The login and token used below are for this example only. You need to use your own login and token. 

• login: client 

• token: pass99 

• key: 1 to 5 

Calculation of the MD5 hash: 

• md5 = md5_hex(login. token, key) 
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Results 

I" key = 1, md5 = 2f922ef79253f93d0fc05d0ac0b0dl00 
| key = 2, md5 = 43dd325a272140a9f47a3be015eb8129 
| key = 3, md5 = cc98cf7d902047101be5635f6af3877e 
| key = 4, md5 = b4a9d3a95ac0efb73d840bd0dbbeldlc 
| key = 5, md5 = a43cff6e5d057f84blae99e64245bff8 


As you can see in these samples, the calculated key is distinct for each transaction. 

2.4 Timeout Parameter 

More than 99.5% of the transactions are currently processed within a few seconds. 

However, it may happen in some rare cases that a transaction takes longer to be processed by the re¬ 
ceiving operator due to congested system on their end for instance. 

TransferTo guarantees that transactions not processed within 600 seconds will not be charged, whatever 
the final status of the transaction (successful or not). In addition, TransferTo is operating a real time sys¬ 
tem; therefore, the status returned in the Top-up response is final and will not change. 

To ensure that your system captures successfully the status of all transactions especially the longest 
ones, it is advised to either set up a high timeout value of 600seconds to be on the safe side (TCP con¬ 
nection could potentially be opened for a long time in this case) or to set up a mechanism to check on 
the status (to do so, you can call the transjnfo method to retrieve the final status of a transaction). 

In case of timeout, both methods reservejd and get_id_from_key of the API could be useful to identify 
the ID of the transaction (we recommend to either send a reservejd request and to use the ID returned 
in the response in the subsequent top-up request so that you know in advance the ID of the transaction). 

2.5 Account, Sub-Accounts 

TransferTo creates an account, and you can retrieve your token through the portal with the login name 
provided. This account stands for your master account. 

If you're looking to create sub-accounts, this is possible thanks to TransferTo web interface: 

To create a sub-account 

1. Login to http://shop.transferto.com/ . 

2. Accept Terms and Conditions. 

3. Click on Manage Users button and then on + Add a New User 

4. Fill out the form (define login/password, contact information, etc.). For balance settings, 
please refer to section 2.6 hereafter. 

Your sub-account is created. Your new sub-account user will receive an email invitation. 
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2.6 Account balance: How does it work? 

Master account 

TransferTo system works on a prepaid basis. Each new account is initialized with a minimum amount in 
their balance allowing to perform the basic tests. Check your balance by either connect to the web inter¬ 
face (see hereafter) or use the API method described in chapter 7.1. 

To consult your balance and credit your account 

1. Login to http://shop.transferto.com/ . 

2. Your balance is displayed on the top left corner. 

3. Select Add Credit from the top menu (next to your balance). 

4. Follow the instructions to credit your account balance. 

The main payment method supported by TransferTo platform is the bank transfer. Details on bank ac¬ 
count can be find directly on the web interface. Moreover, other payments methods are provided de¬ 
pending on your location. 

Sub accounts 

There are 3 things to know for sub-account balance management: 

1. Sub-account balance can be shared with master (default setting) 

This is defined at sub-account creation. If shared, each transaction will imply a debit from 
master account balance. Else, only sub-account balance will be impacted. 

2. A daily limit can be fixed on sub-account balance 

To define a daily limit 

a. Login to your master account on http://shop.transferto.com/ . 

b. Click on Manage Users button and search for your sub-account login name 

c. Define the limitation in Daily Limit column 

Note: the sub-account's balance is automatically reset to the daily limit amount every day at 
Olh GMT. 

3. Sub-account balance is credited from Master 

To credit your sub-account balance 

a. Login to your master account on http://shop.transferto.com/ . 

b. Click on Manage Users button and search for your sub-account login name 

c. Define the amount in Manage Funds column and click Add. This amount will be debited 
from your Master account balance. 


To check your master account balance, you must send the request with the login name provided by 
TransferTo. 

To check your sub-account balance, you must send the request with the login name defined at sub¬ 
account creation. 

Please refer to section 7.1 to see more details on how to check account balance. 
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2.7 Get ready, test your account! 

The URL to reach TransferTo Top-up API is: https://airtime.transferto.com/cgi-bin/shop/topup 
Before starting, check your account credentials by using the ping method. 

Then, try to simulate a Top-up (method simulation) and also the most common error codes returned by 
TransferTo system in the topup method response. 

Please refer to section 0 for more details. 
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3.0 API Overview 

This API enables developers to access some of the core primitives of TransferTo platform including 
msisdnjnfo, reservejd and topup. In addition, this API also offers several methods identified by a 
specific value of the parameter "action". 


Account 



Basics 


Airtime Recharge 
Query 

msisdn_info 
reserve id 



Tests 


Simulate Top-up 
and Error Codes 

ping 

simulation 



Balance, Offer and 
Pricelist Query 

check_wallet 

pricelist 



Reports 


Transaction 
Information Query 

trans_info 
trans_list 
get_id_from_key 


r ^ 

Advanced values 

PLN and DTH Recharge Query 
_ ) 
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Basics 


Action 

Description 

msisdn_info 

Returns relevant information on a MSISDN (operator, country...) as well as the 
list of products configured for your account and the destination operator 
linked to that MSISDN. Allows to check if a MSISDN is subjected to a promo¬ 
tion. 

reservejd 

Returns a transaction ID reserved in the system to be used during next topup 
or simulation query. This way, your system has the ID of the transaction be¬ 
fore sending the request to TransferTo. Otherwise, it will appear only in the 

response. 

topup 

Allows to conduct a Top-up. Returns transaction details based on product type 
(PIN-Less or PIN-Based): transaction id and status, error code, pin information, 
local amount received, etc. 


Account 


Action 

Description 

check_wallet 

Returns your account balance. 

Do not use this method more than 24 times per day. 

pricelist 

Returns information configured in your account such as counties list, opera¬ 
tors list, or products list and prices (wholesale and retail). 


Tests 


Action 

Description 

ping 

Allows to check account credentials. 

simulation 

This method is used to simulate a Top-up. It takes the same arguments as 
topup action. It does not perform a real Top-up to the destination number. 


Reports 


Action 

Description 

transjnfo 

Returns all available information on a specific transaction ID. 

transjist 

Returns the list of transactions performed during a given date range. 

get_id_from_key 

Returns the ID of a transaction previously performed based on the key used in 
the request at that time. 
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4.0 Basics: Airtime Recharge Query 

This section introduces the different steps to the Top-up process flow: 

• Retrieve information on a MSISDN 

• Reserve an ID in the system 

• Send an airtime recharge 


4.1 Introduction to Top-up End-To-End Flow 

Using "msisdnjnfo", "reservejd" and "topup" Methods 

The following process describes a typical transaction flow based on the main methods provided by the 
API: 


Your platform 


Step 1 


Step 2 


Step 3 


TransferTo 


(https) 


Cad API method aiai adn info (destination number) 


<MOf. rTOOU 


Returns available products list 


Call API method go serve id 


Returns an ID for next transaction 


Call API method ssbhb. (destination number, product. aammLUfl 


I tOOUD 


Destination 

Operator direct topup platform 


Credit the destination number account 

successful 


Error code 0 returned 


Returns the error code 


Figure 1 - Top-up Process Flow 
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SMS Management 

By default, an SMS notification is sent to the recipient after every successful Top-up. 

The following is the default SMS which is translated into local languages for most of recipient countries: 


Congratulations! You've received 
AMOUNT_CURRENCY from SENDER. Thank you for us¬ 
ing TransferTo. FREE_TEXT. 


• AMOUNT CURRENCY is the amount that has 
been sent with the currency. 

• SENDER can be a name or a phone number. 

• FREE_TEXT is the content of the field named 
"sms" of the topup method. 


Example: 



The default originating address for 
the SMS is "8888". 
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4.2 Get details on a MSISDN 

Purpose: Check phone number format; Get operator and available denominations; etc. 



Figure 2 - "msisdnjnfo Method Illustration" 


Method msisdnjnfo 

Returns relevant information on a MSISDN (operator, country...) as well as the list of products configured 
for your account and the destination operator linked to that MSISDN. Allows to check if a MSISDN is sub¬ 
jected to a promotion. 
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Request Parameters 


Name 

Type 

Required 

(Yes/No) 

Description 

login 

Alphanumeric 

String 

Y 

Account login name provided by TransferTo. 

key 

Integer 

Y 

Key generated by the client. The transaction is 
rejected if the key has been used. 

md5 

Alphanumeric 

String 

Y 

MD5 sum of the hex encoded concatenation 

of login, token, and key. 

action 

Alphanumeric 

String 

Y 

Must be set to "msisdnjnfo" 

destination_msisdn 

Numeric String 

Y 

Destination MSISDN (usually recipient phone 
number). 

This is the destination phone number that will 

be credited with the amount transferred. 

Format is similar to "msisdn" and restricted to 

international phone number only. 

delivered_amount_info 

Alphanumeric 

String 

(less than 2 
chars) 

N 

Setting this to "1" will return the fields lo- 
cal_info_amount_list, local_info_currency 
and local_info_value_list in the API response. 
Blank or "no" if you do not want this re¬ 
turned. 

return_service_fee 

Numeric 

N 

Setting this to "1" will return the field ser- 
vice_fee_list in the API response. Blank or "0" 
if you do not want it returned. 

operatorid 

Integer 

N 

Operator ID of the receiving operator that 
must be used when treating the request. If 
set, the platform will be forced to use this op¬ 
erator ID and will not identify the operator of 

the destination MSISDN based on the num¬ 
bering plan. 

It is very useful in case of countries with num¬ 
ber portability if you are able to know the 
destination operator. 

return_promo 

Numeric 

N 

Setting this to "1" will return the current 
promotion related to the transaction's opera¬ 
tor. 
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Response Parameters 


Name 

Type 

Description 

authentication_key 

Integer 

Key generated by the client to perform the request 
(specified in key request parameter). The transaction is 
rejected if the key has been used. 

error_code 

Integer 

Error code of the transaction. Refer to section 9.0 to 

see the list of error codes returned by the API. 

error_txt 

Alphanumeric 

String 

Description of the error. 

country 

Alphanumeric 

String 

Country of the destination operator. 

countryid 

Integer 

Unique ID of the destination country. 

operator 

Alphanumeric 

String 

Destination operator name. 

operatorid 

Integer 

Destination operator ID returned only if forced by cli¬ 
ent, else blank. 

connection_status 

Integer 

Shows successful rate to the destination operator. 

1-100 with 100 being 100% success rate. 

destination_msisdn 

Numeric String 

Destination MSISDN (usually recipient phone number). 

destination_currency 

Alphanumeric 

String 

Currency of the destination country. 

productjist 

String 

Returns the list of all available products configured for 

the current account. 

Products are separated by a comma. 

service_fee_list 

String 

Returns the list of all service fee configured for the cur¬ 
rent account. 

Prices are separated by a comma and in the currency of 

the current account. 

retail_price_list 

String 

Returns the list of all final retail prices configured for 

the current account. 

Prices are separated by a comma and in the currency of 

the current account. 

wholesale_price_list 

String 

Returns the wholesale price (also known as Your Cost) 
list of all available products configured for the current 

account. 

Prices are separated by a comma and in the currency of 

the current account. 
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Name 

Type 

Description 

local_info_armount_list 

String 

List of final amounts received by recipient (after taxes 
and operator fees). Indicative value only. 

local_info_value_list 

Numeric 

List of each product amount (before taxes and service 
fees) in local currency. 

local_info_currency 

Alphanumeric 

String 

Currency of the destination country. 

promotion 

Alphanumeric 

String 

Promotion details. Returned only when requested with 
return_promo field. 

promo_start 

Date 

Promotion start date (e.g "yyyy- mnr >-dd 
hh:mm:ss+offset"). 

promo_end 

Date 

Promotion end date (e.g "2013-12-01 13:05:55+00"). 


Sample Request 

<xml> 

<login>test</login> 

<key>1326965217</key> 

<md5>md5</md5> 

<destination_msisdn>+60172860300</destination_msisdn> 

<delivered_amount_info>l</delivered_amount_info> 

<return_service_fee>l</return_service_fee> 

<action>msisdn_info</action> 

</xml> 

1 Enter Number 2 Choose Product 3 Review 8t Send 4Transaction Details 


Ent<grTecipientr^ +6 oi 728603 oo 


Change 


find country code 
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Sample Response 


<TransferTo> 

<country>Malaysia</country> 

<countryid>799</countryid> 

<operator>Maxis Malaysia</operator> 

<operatorid>385</operatorid> 

<connection_status>100</connection_status> 

<destination_msisdn>60172860300</destination_msisdn> 

<destination_currency>MYR</destination_currency> 

<product_list>5,10,20,30</product_list> 

<service_fee_list>0.00,0.00,0.00,0.00</service_fee_list> 
<retail_price_list>2. 10,4.00,7.80,11. 60</retail_price_list> 
<wholesale_price_list>1.95,3.72,7.25,10.79</wholesale_price_list> 
<authentication_key>1326965217</authentication_key> 
<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 

<local_info_amount_list>5.00,10.00,20.00,30.00</local_info_amount_list> 

<local_info_valuejist>5.00,10.00,20.00,30.00</local_info_value_list> 

<local_info_currency>MYR</local_info_currency> 

</TransferTo> 


Country: 



Operator: <C^ Maxis Malays ia^) 

maxis 


Select Top-Up amount 
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4.3 Reserve an ID 


Purpose Get a reserved ID from the system 



Method reserve id 

Returns a transaction ID reserved in the system to be used in during next topup or simulation query. This 
way, your system has the ID of the transaction before sending the request to TransferTo. Otherwise, it 
will appear only in the response. 


Request Parameters 


Name 

Type 

Required 

(Yes/No) 

Description 

login 

Alphanumeric 

String 

Y 

Account login name provided by Transfer¬ 
To. 

key 

Integer 

Y 

Key generated by the client. The transac¬ 
tion is rejected if the key has been used. 

md5 

Alphanumeric 

String 

Y 

MD5 sum of the hex encoded concatena¬ 
tion of login, token, and key. 

action 

Alphanumeric 

String 

Y 

Must be set to "reserveJd" 
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Response Parameters 


Name 

Type 

Description 

authentication_key 

Integer 

Key generated by the client to perform the request (speci¬ 
fied in key request parameter). The transaction is rejected if 
the key has been used. 

error_code 

Integer 

Error code of the transaction. Refer to section 9.0 to see the 

list of error codes returned by the API. 

error_txt 

Alphanumeric 

String 

Description of the error. 

reservedjd 

Numeric 

Reserved ID in TransferTo system to use in the next topup or 
simulation request. 


Request 

<xml> 

<login>your_login</login> 

<key>1217303174266</key> 

<md5>b70aa58d2fe87d0bb0cd2bl902e5fce2</md5> 

<action>reserve_id</action> 

</xml> 


Response 

<TransferTo> 

<status_code>0</status_code> 
<reserved_id>20123457</reserved_id> 
<error_txt>Transaction successful</error_txt> 
<authentication_key>1217303174266</authentication_key> 
<error_code>0</error_code> 

</TransferTo> 
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4.4 Conduct a Top-up 

Purpose Send an airtime recharge 



Method topup 

Allows to conduct a Top-up. Returns transaction details based on product type (PIN-Less or PIN-Based): 
transaction id and status, error code, pin information, local amount received, etc. 

Request Parameters 


Name 

Type 

Required 

(Yes/No) 

Description 

login 

Alphanumeric 

String 

Y 

Account login name provided by 

TransferTo. 

key 

Integer 

Y 

Key generated by the client. The 
transaction is rejected if the key has 

been used. 

md5 

Alphanumeric 

String 

Y 

MD5 sum of the hex encoded con¬ 
catenation of login, token, and key. 

action 

Alphanumeric 

String 

Y 

Must be set to "topup" 
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Name 

Type 

Required 

(Yes/No) 

Description 

destination_msisdn 

Numeric String 

Y 

Destination MSISDN (usually recipi¬ 
ent phone number). 

This is the destination phone num¬ 
ber that will be credited with the 

amount transferred. Format is simi¬ 
lar to "msisdn" and restricted to in¬ 
ternational phone number only. 

return_service_fee 

Numeric 

N 

Setting this to "1" will return the 
field service_fee_list in the API re¬ 
sponse. Blank or "0" if you do not 

want it returned. 

operatorid 

Integer 

N 

Operator ID of the receiving opera¬ 
tor that must be used when treating 
the request. If set, the platform will 
be forced to use this operator ID 
and will not identify the operator of 

the destination MSISDN based on 

the numbering plan. 

It is very useful in case of countries 
with number portability if you are 
able to know the destination opera¬ 
tor. 

return_promo 

Numeric 

N 

Setting this to "1" will return the 
current promotion related to the 
transaction's operator. 

msisdn 

Alphanumeric 

String 

Y 

The international phone number or 
name of the user requesting to 
credit a phone number (sender 
phone number). The format must 
contain the country code, and will 

be valid with or without the '+' or 

'00' placed before it. For example: 

"6012345678" or "+6012345678" or 

"006012345678" (Malaysia) or 

"John" are all valid. This field must 

not be empty. 

product 

Alphanumeric 

String 

Y 

Product (or denomination) to use in 
the request (often, the same as the 
amount in destination currency). 
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Name 

Type 

Required 

(Yes/No) 

Description 

cidl 

Alphanumeric 
String (less 
than 64 chars) 

N 

This field can be used to record any 
kind of information when perform¬ 
ing a transaction. It is stored in 
TransferTo database and may ap¬ 
pear in various reports. 

cid2 

Alphanumeric 
String (less 
than 64 chars) 

N 

This field can also be used to record 

any kind of information when per¬ 
forming a transaction. It is stored in 
TransferTo database and may ap¬ 
pear in various reports. 

cid3 

Alphanumeric 
String (less 
than 64 chars) 

N 

This field can also be used to record 

any kind of information when per¬ 
forming a transaction. It is stored in 
TransferTo database and may ap¬ 
pear in various reports. 

reservedjd 

Numeric String 

N 

If defines, TransferTo system will 
use the previously reserved ID (via 
Method "reservejd") for this trans¬ 
action. 

send_sms 

Alphanumeric 
String (yes or 
no) 

N 

Recipient SMS 

When this field is set to "no", the 

notification SMS is not sent to the 

recipient. 

When this field is not defined or not 

equals to "no", the default SMS is 
sent to recipient. 

sms 

Alphanumeric 
String (less 
than 30 chars) 

N 

Recipient SMS 

This field is used to send your own 
free text message. It will be ap¬ 
pended to the default notification 

SMS sent to the recipient. It does 

NOT define the entire content of 

the SMS sent to recipient. 

Must be less than 30 chars and spe¬ 
cial characters have to be encoded 

(&, <, >...). 

sender_sms 

Alphanumeric 

String 

N 

Sender SMS 

"yes" if required, blank or "no" if 
not required. 
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Name 

Type 

Required 

(Yes/No) 

Description 

sender_text 

Alphanumeric 
String (less 
than 30 chars) 

N 

Sender SMS 

Used only if "sender_sms" is equals 
to "yes". 

This field is used to send your own 
free text message. It will be ap¬ 
pended to the default notification 

SMS sent to the sender. It does NOT 

define the entire content of the 

SMS sent to sender. 

delivered_amount_info 

Alphanumeric 
String (less 
than 2 chars) 

N 

Setting this to " 1 " will return the 
fields local_info_amount_list, lo- 
cal_info_currency and lo- 
cal_info_value_list in the API re¬ 
sponse. Blank or "no" if you do not 

want this returned. 

return_timestamp 

Numeric 

N 

Setting this to " 1 " will return the 
field timestamp in the API response. 
Blank or " 0 " if you do not want it re¬ 
turned. 

return_version 

Numeric 

N 

Setting this to "1" will return the API 
version in the API response. Blank 
or "0" if you do not want it re¬ 
turned. 


Response Parameters 

Our system can return two possible responses depending on the type of recharge performed: Pin-Less or 
Pin-Based. 


4.4.1 PIN Less Versus PIN Based Operators 

Most receiving operators (or carriers) are PIN less (direct top-up), meaning that the mobile phone of the 
recipient is recharged in real time. A few operators are however PIN based (mostly in the USA and UK). 
For these PIN based operators, a PIN code is sent by SMS to the recipient, who then has to manually 
complete the recharge process (usually by calling an IVR to redeem the PIN). 

The responses of the topup method are slightly different depending on the type of the operator: some 
additional fields are returned in case of PIN based operator (IVR number, PIN code, instructions on how 
to redeem it, expiration date...). 
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Example of PIN based answer: 


1 Enter Number 2 Choose Product 3 Review 6t Send 4 Transaction Details 


Transaction Details 

Status: Transaction successful 


Number: 

Operator: 

Date: 

Transaction ID: 


15105987461 

Red P 1 (XXX) XXX-XXXX 

Wed Nov 20 2013 4:19:02 PM 

159573786 



Product: 19.99 USD 

Value sent: 20 USD (before taxes) 


4.4.2 PIN Less 


Response Parameters 


Name 

Type 

Description 

authentication_key 

Integer 

Key generated by the client to perform the request 
(specified in key request parameter). The transaction 
is rejected if the key has been used. 

error_code 

Integer 

Error code of the transaction. Refer to section 9.0 to 

see the list of error codes returned by the API. 

error_txt 

Alphanumeric 

String 

Description of the error. 

country 

Alphanumeric 

String 

Country of the destination operator. 

countryid 

Integer 

Unique ID of the destination country. 

operator 

Alphanumeric 

String 

Destination operator name. 

operatorid 

Integer 

Destination operator ID returned only if forced by 
client, else blank. 

destination_msisdn 

Numeric String 

Destination MSISDN (usually recipient phone num¬ 
ber). 
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Name 

Type 

Description 

destination_currency 

Alphanumeric 

String 

Currency of the destination country. 

local_info_currency 

Alphanumeric 

String 

Currency of the destination country. 

promotion 

Alphanumeric 

String 

Promotion details. Returned only when requested 
with return_promo field. 

promo_start 

Date 

Promotion start date (e.g "yyyy-mm-dd 
hh:mm:ss+offset"). 

promo_end 

Date 

Promotion end date (e.g "2013-12-01 13:05:55+00"). 

msisdn 

Alphanumeric 

String 

The international phone number or name of the user 
(sender) requesting to credit a phone number. 

originating currency 

Alphanumeric 

String 

Currency of the account from which the transaction 
is requested. 

product_requested 

Float 

Value of the product defined in "product" field of the 
topup request. 

actual_product_sent 

Float 

Returns the value requested to the operator (equals 
to product_requested in case of successful transac¬ 
tion). It equals to 0 when Top-up failed. 

sms_sent 

Alphanumeric 

String 

Recipient SMS 

Defines the status of the notification SMS sent to the 

recipient. 

Returns "yes" only if the SMS has been successfully 

sent. 

sms 

Alphanumeric 

String 

Recipient SMS 

Returns the custom message appended to the de¬ 
fault notification SMS sent to the recipient. 

sender_sms 

Alphanumeric 

String 

Sender SMS 

Defines the status of the notification SMS sent to the 

sender. 

Returns "yes" only if the SMS has been successfully 

sent. 

sender_text 

Alphanumeric 

String 

Sender SMS 

Returns the custom message appended to the de¬ 
fault notification SMS sent to the sender. 

wholesale_price 

Numeric 

Returns the cost of the product defined in "product" 
field of the request. This cost is set in the account's 

currency. 
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Name 

Type 

Description 

service_fee 

Numeric 

Returns the service fee of the product as configured 

in the account. 

retail_price 

Numeric 

Returns the retail price of the product as configured 

in the account. 

transactionid 

Integer 

ID of the transaction. 

cidl 

Alphanumeric 

String 

Value of the customized field cidl sent in the Top-up 

request. 

cid2 

Alphanumeric 

String 

Value of the customized field cid2 sent in the Top-up 

request. 

cid3 

Alphanumeric 

String 

Value of the customized field cid3 sent in the Top-up 
request. 

reference_operator 

Alphanumeric 

String 

Reference of the operator (returned only if availa¬ 
ble). 

local_info_amount 

Numeric 

Final amount received by recipient (after taxes and 
operator fees). Indicative value only. 

local_info_value 

Numeric 

Amount of the product (before taxes and service 
fees) in local currency. 

return_timestamp 

Date 

Timestamp recorded for this transaction (e.g "2013- 
03-18 00:00:00"). 

return_version 

Numeric 

Version of this API. 

balance 

Numeric 

For main account: returns the account's remaining 

balance. 

For sub-account: returns the account's remaining 
limit balance of the day if a daily limit is fixed. Else, 
returns the account remaining balance. 
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Sample Request 

<xml> 

<login>test</login> 

<key>1326963417</key> 

<md5>md5</md5> 

<msisdn>69999999999</msisdn> 

<sms>Happy birthday !</sms> 

<destination_msisdn>+60172860300</destination_msisdn> 

<product>10</product> 

<cidl>My Text</cidl> 

<sender_sms>yes</sender_sms> 

<sender_textx/sender_text> 

<delivered_amount_info>l</delivered_amount_info> 

<return_timestamp>l</return_timestamp> 

<return_version>l</return_version> 

<return_service_fee>l</return_service_fee> 

<action>topup</action> 

</xml> 
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Sample Response 

<TransferTo> 

<transactionid>77748538</transactionid> 

<msisdn>69999999999</msisdn> 

<destination_msisdn>60172860300</destination_msisdn> 

<country>Malaysia</country> 

<countryid>799</countryid> 

<operator>Maxis Malaysia</operator> 

<reference_operatorx/reference_operator> 

<operatoridx/operatorid> 

<originating_currency>USD</originating_currency> 

<destination_currency>MYR</destination_currency> 

<product_requested>10</product_requested> 

<actual_product_sent>10</actual_product_sent> 

<wholesale_price>3.39</wholesale_price> 

<service_fee>0.00</service_fee> 

<retail_price>4.30</retail_price> 

<balance>8.1</balance> 

<sms_sent>yes</sms_sent> 

<sms>Happy birthday </sms> 

<sender_sms>yes</sender_sms> 

<sender_textx/sender_text> 

<cidl> My Text </cidl> 

<cid2x/cid2> 

<cid3x/cid3> 

<authentication_key>1326963417</authentication_key> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 

<local_info_value>10.00</local_info_value> 

<local_info_amount>10.00</local_info_amount> 

<local_info_currency>MYR</local_info_currency> 

<return_timestamp>2013-03-18 00:00:01</return_timestamp> 
<return_version>1.06.08</return_version> 

</TransferTo> 
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4.4.3 PIN Based 

Response Parameters (additional parameters applicable to PIN Based only) 


Name 

Type 

Description 

pin_based 

String 

Returns "Yes" if PIN-based transactions. Else "No". 

pin_option_l 

String 

Additional information. For example, it can describe how to use 
the PIN directly from handset (by entering a dedicated USSD 
code). 

pin_option_2 

String 

Additional information. For example, it can provide the opera¬ 
tor refill website. 

pin_option_3 

String 

Additional information. For example, it can provide the opera¬ 
tor refill call center. 

pin_value 

Integer 

Value of the PIN. 

pin_code 

Alphanumeric 

String 

Code of the PIN. 

pinjvr 

Integer 

IVR number of the PIN. 

pin_serial 

Alphanumeric 

String 

Serial number of the PIN. 

pin_validity 

String 

Validity of the PIN. 


Sample Request 

<xml> 

<login>test</login> 

<key>1326964272</key> 

<md5>md5</md5> 

<msisdn>69999999999</msisdn> 

<sms>Test credit from TransferTo</sms> 

<destination_msisdn>00009779742045269</destination_msisdn> 

<product>200</product> 

<delivered_amount_info>l</delivered_amount_info> 

<action>Top-up</action> 

</xml> 


TransferTo Inc. - Cross-Border Mobile Payments 
© Copyright 2016 - Confidential 


















Airtime API Document 
Version No. 2.8.3 



TransferTo 


Sample Response 1/2 

<TransferTo> 

<transactionid>77749654</transactionid> 

<msisdn>69999999999</msisdn> 

<destination_msisdn>9779742045269</destination_msisdn> 

<country>Nepal</country> 

<countryid>819</countryid> 

<operator>NTC CDMA Nepal</operator> 
<reference_operatorx/reference_operator> 

<operatoridx/operatorid> 

<originating_currency>USD</originating_currency> 

<destination_currency>NPR</destination_currency> 

<product_requested>200</product_requested> 

<actual_product_sent>200</actual_product_sent> 

<wholesale_price>2.58</wholesale_price> 

<service_fee>0.00</service_fee> 

<retail_price>3.30</retail_price> 

<balance>5.52</balance> 

<sms_sent>yes</sms_sent> 

<sms>Test credit from TransferTo</sms> 

<cidlx/cidl> 

<cid2x/cid2> 

^cid.S^/cid.S^ 

<pin_based>yes</pin_based> 

<pin_option_l>To recharge your mobile, dial 1415 from your own Pre-Paid mo¬ 
bile phone and follow thq instructions.</pin_option_l> 
<pin_option_2>SkyPhoneVpin_option_2> 

<pin_option_3x/pin_optio\_3> 

<pin_value>200</pin_value>\ 

<pin_code>12345678901234<\in_code> 

<pin_ivr>1415</pin_ivr> \ 

<pin_serial>123456789123456789ypin_serial> 

<pin_validity>30 Days</pin_validity> 


^1 Enter Number 2 Choose Product 3 Review fit Send 4 Transaction Details 

Transaction Details 


Status: 

Number: 

Operator: 

Date: 

Transaction ID: 


Transaction successful 

9779742045269 

NTC CDMA Nepal 

Fri Apr 25 2014 12:45:08 PM 

77749654 


PIN Info 1: To recharge your mobile, dial 1415 

from your own Pre-Paid mobile phone and follow the 
instructions. 


PIN Info 2: SkyPhone 

PIN Value: 200 
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Sample Response 2/2 


<service_fee>0.00</service_fee> 

<retail_price>3.30</retail_price> 

<authentication_key>1326964272</authentication_key> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 
<local_info_value>200.00</local_info_value> 

<local_info_amount>200.00</local_info_amount> 

<local_info_currency>NPR</local_info_currency> 

</TransferTo> 


1 Enter Number 2 Choose Product 3 Review 8t Send 4 Transaction Details 


Transaction Details 


Status: 

Number: 

Operator: 

Date: 

Transaction ID: 


Transaction successful 

9779742045269 

NTC CDMA Nepal 

Fri Apr 25 2014 12:45:08 PM 

77749654 


PIN Info 1: To recharge your mobile, dial 1415 from your 

own Pre-Paid mobile phone and follow the instructions. 

PIN Info 2: SkyPhone 


PIN Value: 
PIN Code: 
PIN IVR: 
PIN Serial: 


200 

1234 5678 9012 34 
1415 

123 456 789 123 456 789 


PIN Validity: 30 Days 

Value sent: 200 NPR (before taxes) 

Value received*: 200 NPR (after taxes + operator fees) 
Transaction Fee: 0.00 USD 


Amount paid: 3.30 USD includes a service fee of 0.00 


* Estimate only. Actual amount received by recipient may differ from dis¬ 
played amount. 
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4.4.4 Check if a MSISDN is subjected to a promotion 

Both msisdnjnfo and topup methods allow to return the promotion related to a given phone number of 
destination. Hereafter is an example with return_promo field requested (equals to 1) and subsequent re¬ 
sponses (promotion detail, start and end dates). 

Sample Request 

\ <xml> 

j <login>test</login> 

; <key>1326963417</key> 

| <md5>md5</md5> 
j <msisdn>69999999999</msisdn> 

| <sms>Happy birthday !</sms> 

; <destination_msisdn>+60172860300</destination_msisdn> 

; <product>10</product> 

| <cidl>My Text</cidl> 

; <sender_sms>yes</sender_sms> 

; <sender_textx/sender_text> 

| <delivered_amount_info>l</delivered_amount_info> 

| <return_promo>l</return_promo> 

| <return_timestamp>l</return_timestamp> 

| <return_version>l</return_version> 

| <return_service_fee>l</return_service_fee> 

| <action>topup</action> 

| </xml> 
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Sample Response 

<TransferTo> 

<transactionid>77748538</transactionid> 

<msisdn>69999999999</msisdn> 

<destination_msisdn>60172860300</destination_msisdn> 

<country>Malaysia</country> 

<countryid>799</countryid> 

<operator>Maxis Malaysia</operator> 

<reference_operatorx/reference_operator> 

<operatoridx/operatorid> 

<originating_currency>USD</originating_currency> 

<destination_currency>MYR</destination_currency> 

<product_requested>10</product_requested> 

<actual_product_sent>10</actual_product_sent> 

<wholesale_price>3.39</wholesale_price> 

<service_fee>0.00</service_fee> 

<retail_price>4.30</retail_price> 

<balance>8.1</balance> 

<sms_sent>yes</sms_sent> 

<sms>Happy birthday </sms> 

<sender_sms>yes</sender_sms> 

<sender_textx/sender_text> 

<cidl> My Text </cidl> 

<cid2x/cid2> 

<cid3x/cid3> 

<authentication_key>1326963417</authentication_key> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 

<local_info_value>10.00</local_info_value> 

<local_info_amount>10.00</local_info_amount> 

<local_info_currency>MYR</local_info_currency> 

<return_timestamp>2013-03-18 00:00:01</return_timestamp> 

<return_version>1.06.08</return_version> 

<promotion>Promotion: Quadruple (4x) Balance&lt;br/&gt;Operator: Claro&lt;br/&gt;Country: Nicara- 
gua&lt;br/&gt;Denominations (USD): 5 and above&lt;br/&gt;Date: December 16th, 2013 to December 
19th,2013 at 11:59 pm (-6 GMT)&lt;br/&gt;&lt;br/&gt;Terms and Conditions:&lt;br/&gt;- Claro network 
calls&lt;br/&gt;- Call international destinations&lt;br/&gt;- Calling other operators according to the user 
profile&lt;br/&gt;- For refills $5 to $11 your bonus will expire in 30 days&lt;br/&gt;- For refills $12 and 
above your bonus will expire in 45 days&lt;br/&gt;&lt;br/&gt;Exceptions promotional balance (not to be 
used)&lt;br/&gt;- Send Text Messages&lt;br/&gt;- Calling other operators according to the user pro- 
file&lt;br/&gt;- Internet Browsing</promotion> 

<promo_start>2013-12-15 16:00:00+00</promo_start> 

<promo_end>2015-12-31 15:59:00+00</promo_end> 

</TransferTo> 
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5.0 Advanced values across borders 

As described in previous chapter, TransferTo API main purpose is to allow customers to perform airtime 
recharges. However, TransferTo API is also designed to offer other recharge solutions such as Electricity 
in Indonesia (as known as PLN) and DTH television in India and Philippines. 


This chapter describes the main methods of TransferTo API for each specific product: 

• Perform a msisdnjnfo query to retrieve the available recharge amounts 

• Use the topup method to complete the recharge 

Moreover, it provides you with the different kind of responses (PIN Based / PIN Less) returned by the API 
and based upon the type of service. 

5.1 Prepaid Electricity 

5.1.1 PLN Indonesia: PIN Based 


Description 

A PLN product is a prepaid electricity voucher expressed in the form of a 20 digits PIN. 

As the top-up solution, TransferTo provides solutions enabling migrants to conveniently recharge the 
PLN account to their loved ones in Indonesia. 


Pre-conditions 

In order to generate the PIN and ensure that it is sent to the right person, you must provide the follow¬ 
ing parameters: 

1. Recipient's PLN prepaid meter number (11 digits) 

Note: The recipient of the PIN must have a prepaid electricity account with PLN, a leading utility company 
in Indonesia. 


2. Recipient's phone number 

Note: Once generated, the PIN is sent to the recipient via SMS. Then, the PIN must be entered by the re¬ 
cipient into their prepaid electricity meter to recharge their meter value. 
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Method msisdn info 


Sample query 

<xml> 

<login>your_login</login> 

<key>1326965217</key> 

<md5>md5</md5> 

<destination_msisdn>PLN14032918279_628123456770</destination_msisdn> 

<operatorid>1671</operatorid> 

<action>msisdn_info</action> 

</xml> 


Response parameters are similar to the ones described in chapter 4.2. 

List of available PLN products is returned in the parameter named productjist. 


Method topup 


Sample query 

<xml> 

<login>your_login</login> 

<key>1326965217</key> 

<md5>md5</md5> 

<destination_msisdn>PLN14032918279_628123456770</destination_msisdn> 

<operatorid>1671</operatorid> 

<msisdn>sender number</msisdn> 

<product>10000</product> 

<action>topup</action> 

</xml> 


In both methods you must fill the destination_msisdn parameter with: 

1. Recipient's PLN prepaid meter number (e.g 14032918279) 

2. Recipient's phone number (e.g 628123456770) 


Response parameters are similar to the ones described in chapter 4.4.3. 

The final PIN is returned in the parameter named pin_code. This PIN is also sent to the recipient phone 
number that you can find in response parameter named destination_msisdn. 
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5.2 International Calling Service - PINLESS/PINFREE 

The International Calling Service Pinless allows users to make international calls without the attachments 
to any phone provider. Simple register your phone number to any of the providers and enjoy interna¬ 
tional phone service at much better rates than regular phone operators. 

5.2.1 DollarPhone PINLESS 

DollarPhonePinless is a high-quality prepaid international calling service you can use with any phone. 
There are no hidden fees, no contracts, and it works automatically with your current phone service. 


Pre-conditions 

In order to create a new account or reload a current one, you must provide the following parameters: 

1. Valid USA Phone number. 

Note: If there is a new account, account will be created automatically and the account recipient will re¬ 
ceive and SMS with the access information to make international calls. 

If there is a current account, the topup will be credited and the customer will be notified of the recharge. 


2. Operator ID (2010) 

Note: Operator needs to be forced in order to use this service via API. 


Method msisdn info 


Sample query 

<xml> 

<login>your_login</login> 

<key>1326965217</key> 

<md5>md5</md5> 

<destination_msisdn>13057893399</destination_msisdn> 

<operatorid>2010</operatorid> 

<action>msisdn_info</action> 

</xml> 


Response parameters are similar to the ones described in chapter. 

List of available International calling service PINLESS products is returned in the parameter named prod¬ 
uct list. 
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Method 


topup 


Sample query 


<xml> 

<login>your_login</login> 

<key>1420579279</key> 

<md5>83c9c262adfee072edb44500f63flb80</md5> 

<msisdn>13057893399</msisdn> 

<destination_msisdn>13057893399</destination_msisdn> 

<product>l</product> 

<smsx/sms> 

<operatorid>2010</operatorid> 

<action>topup</action> 

</xml> 


Response parameters are similar to the ones described in chapter 4.4.2 
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SMS Notifications from DollarPhone 


New Account: 

^ Messages +1 (813) 413-4727 Details 


Text Message 
Today 4:21 PM 

Welcome DollarPhonePinless! 
To login visit: http:// 
www.dollarphonepinless.com 

. To make calls dial: ( 305) 
434-4312. 


Topup Account: 

^ Messages +1 (408) 713-1460 Details 


Text Message 
Today 4:21 PM 

DollarPhonePinless: $2.00 
has been added to your 
account. Dial ( 305) 434-4312 
to place a call. Customer 
Service ( 888) 903-9047 
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5.3 Prepaid bundles 

Prepaid bundles are a mixture of calls, data, SMS and social media access which the users can purchase 
other than airtime credits. 


Pre-conditions 

To do a recharge, you must provide the following parameters: 

1. Recipient's phone number 

2. Operator ID 

Note: Operator ID needs to be forced in order to use this service via API. 


List of operators offering prepaid bundles - Operator ID 

For the list of operators available to you, please refer to your price list at 

https://shop.transferto.com/cgi-bin/display price list 

You can contact your account manager or email support@transfer-to.com if you're interested to have 
this product added to your account. 


Method msisdn info 


Sample query 

<xml> 

<login>your_login</login> 

<key>1326965217</key> 

<md5>md5</md5> 

<destination_msisdn>521122334455</destination_msisdn> 

<operatorid>2446</operatorid> 

<action>msisdn_info</action> 

</xml> 


Response parameters are similar to the ones described in section 4.2. 

List of available denominations is returned in the parameter named productjist. 
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Method topup 


Sample query 

<xml> 

<login>your_login</login> 

<key>1420579279</key> 

<md5>83c9c262adfee072edb44500f63flb80</md5> 

<msisdn>12025550160</msisdn> 

<destination_msisdn>521122334455</destination_msisdn> 

<product>30</product> 

<smsx/sms> 

<operatorid>2446</operatorid> 

<action>topup</action> 

</xml> 


Response parameters are similar to the ones described in section 4.4.2. 

5.4 Credits 

5.4.1 Viber Out Credits 

Viber Out is a service that allows Viber users to call any phone number at low rates. Calls can be made to 
land lines and mobiles, even if they do not have the Viber Application installed. 

Pre-conditions 

To do a recharge, you must provide the following parameters: 

1. Recipient's phone number 

2. Operator ID 

Note: Operator needs to be forced in order to use this service via API. 


List of Viber Operator ID 

For the list of operators available to you, please refer to your price list at 

https://shop.transferto.com/cgi-bin/display price list 

You can contact your account manager or email support@transfer-to.com if you're interested to have 
this product added to your account. 
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Method msisdn info 


Sample query 

<xml> 

<login>your_login</login> 

<key>1326965217</key> 

<md5>md5</md5> 

<destination_msisdn>151234567890</destination_msisdn> 

<operatorid>2675</operatorid> 

<action>msisdn_info</action> 

</xml> 


Response parameters are similar to the ones described in section 4.2. 

List of available denominations is returned in the parameter named productjist. 


Method topup 


Sample query 

<xml> 

<login>your_login</login> 

<key>1420579279</key> 

<md5>83c9c262adfee072edb44500f63flb80</md5> 

<msisdn>12025550160</msisdn> 

<destination_msisdn>151234567890</destination_msisdn> 

<product>10</product> 

<smsx/sms> 

<operatorid>2675</operatorid> 

<action>topup</action> 

</xml> 


Response parameters are similar to the ones described in section 4.4.2. 

5.5 India Gift Vouchers 

Gift Vouchers are PIN-based digital vouchers. The PIN will be sent via SMS. The users can use the PIN to 
redeem for products and services of the respective merchants. 

Pre-conditions 

To do a recharge, you must provide the following parameters: 

1. Recipient's phone number 

2. Operator ID 

Note: Operator needs to be forced in order to use this service via API. 
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List of Gift Vouchers' Operator ID 

For the list of operators available to you, please refer to your price list at 

https://shop.transferto.com/cgi-bin/display price list 

You can contact your account manager or email support@transfer-to.com if you're interested to have 
this product added to your account. 


Method msisdn info 


Sample query 

<xml> 

<login>your_login</login> 

<key>1326965217</key> 

<md5>md5</md5> 

<destination_msisdn>911234567890</destination_msisdn> 

<operatorid>2758</operatorid> 

<action>msisdn_info</action> 

</xml> 


Response parameters are similar to the ones described in chapter 4.2. 

List of available denominations is returned in the parameter named productjist. 


Method topup 


Sample query 

<xml> 

<login>your_login</login> 

<key>1420579279</key> 

<md5>83c9c262adfee072edb44500f63flb80</md5> 
<destination_msisdn>911234567890</destination_msisdn> 
<msisdn>sender number</msisdn> 
<product>100</product> 

<operatorid>2675</operatorid> 

</xml> 


Response parameters are similar to the ones described in chapter 4.4.3. 
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6.0 Tests: Simulate Top-up and Error codes 

This section is designed for developers who want to test their account credentials, simulate a Top-up, 
simulate different error codes returned by the API, or monitor the connection to the API. 

6.1 Check account credentials 

Method ping 

Allows to check account credentials or to monitor the connection to the API. 


Request Parameters 


Name 

Type 

Required 

(Yes/No) 

Description 

login 

Alphanumeric 

String 

Y 

Account login name provided by TransferTo. 

key 

Integer 

Y 

Key generated by the client. The transaction is rejected if the 
key has been used. 

md5 

Alphanumeric 

String 

Y 

MD5 sum of the hex encoded concatenation of login, token, 
and key. 

action 

Alphanumeric 

String 

Y 

Must be set to "ping" 


Response Parameters 


Name 

Type 

Description 

info_txt 

Integer 

Contains "pong" if the transaction is successful. 

authentication_key 

Integer 

Key generated by the client to perform the request (speci¬ 
fied in key request parameter). The transaction is rejected if 
the key has been used. 

error_code 

Integer 

Error code of the transaction. Refer to section 9.0 to see 

the list of error codes returned by the API. 

error_txt 

Alphanumeric 

String 

Description of the error. 
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Sample Request 

<xml> 

<login>test</login> 

<key>1327027869</key> 

<md5>md5</md5> 

<action>ping</action> 

</xml> 


Sample Response 

<TransferTo> 

<info_txt>pong</info_txt> 

<authentication_key>1327027869</authentication_key> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 

</TransferTo> 


6.2 Monitor connection to the API 

Monitoring the connection to the API can be done easily thanks to the ping method (as described in 
previous chapter). 

6.3 Simulate a Top-up 

Method simulation 

The method simulation takes the same parameters as topup method. It does not perform a real Top-up 
to the destination number. 

This action will test if the destination number is in TransferTo numbering plan, and if the product speci¬ 
fied is valid. 

• It DOES NOT verify if the destination number has expired for instance as the request is 
not submitted to the operator. Thus, a simulation can be successful, while a real top-up 
(request sent to the operator to perform both debit and Top-up) can fail. 

• For PIN Based products, API will respond basics information (PIN Less like). All parame¬ 
ters related to PIN information will not be provided in the response. 

Note that this action will provide you with some information (products available in your account) but is 
not part of the Top-up cycle. You should perform Top-up without making any simulations before. 
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6.4 Simulate error codes 

A few fake phone numbers in Indonesia have been created and set up with available products of IDR 
5000, 10000, 20000, 50000 and 100000: 


628123456710 : 

628123456770 : 

628123456780 : 

628123456781 : 

628123456790 : 

628123456798 : 

628123456799 : 


error code 0 for PIN based Top-up (successful transaction). 

error code 0 for PIN less Top-up (successful transaction). 

error code 204 (destination number is not a valid prepaid phone number). 

error code 301 (input value out of range or invalid product). 

error code 214 (transaction refused by the operator). 

error code 998 (system not available, please retry later). 

error code 999 (unknown error, please contact support). 


TransferTo highly recommend to perform one topup query by phone number listed above, in order to 
ensure the good comprehension of topup responses and to develop a robust error management system. 
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7.0 Account: Balance, Offer and Pricelist Query 

This section describes how to retrieve information on your account as the following: 

• Remaining balance of your master account and sub-accounts 

• Daily limit of a sub-account 

• List of countries offered to your account 

• List of operators offered by country 

• List of denomination, including wholesale and retail prices, offered to your account 

7.1 Check account balance 

Purpose 


Balance: USD 5.99 'dd Credit 


Logout 


Login Name 

Balance 

Manage Funds 
or Limitr?l 

democ 

Shared 

i (i) 

demob 

2.00 

Add or Withdraw 

demo (Master Account) 

5.99 


demoa 

2.00 

Add or Withdraw 


\ 


. Retrieve sub-account balance 
and Daily limit 


Retrieve master account balance 


Retrieve total balance (sum of master and sub accounts) 


Method check wallet 

Returns the balance in your TransferTo account. 

This method shall not be used more than 24 times per day. 

If you just need to monitor the connection to the API, TransferTo highly recommend to use the ping 
method (refer to 6.1). 

Please note that a low balance alert is automatically sent to the email configured in your account when 
the minimum threshold is reached. 
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Request Parameters 


Name 

Type 

Required 

(Yes/No) 

Description 

login 

Alphanumeric 

String 

Y 

Account login name provided by Transfer¬ 
To. 

key 

Integer 

Y 

Key generated by the client. The transac¬ 
tion is rejected if the key has been used. 

md5 

Alphanumeric 

String 

Y 

MD5 sum of the hex encoded concatena¬ 
tion of login, token, and key. 

action 

Alphanumeric 

String 

Y 

Must be set to "check_wallet" 


Response Parameters 


Name 

Type 

Description 

authentication_key 

Integer 

Key generated by the client to perform the request (speci¬ 
fied in key request parameter). The transaction is rejected if 
the key has been used. 

error_code 

Integer 

Error code of the transaction. Refer to section 9.0 to see the 

list of error codes returned by the API. 

error_txt 

Alphanumeric 

String 

Description of the error. 

type 

Alphanumeric 

String 

Account type: "Master" (main account) or "Retailer" (sub¬ 
account) 

name 

Alphanumeric 

String 

Account login name. 

currency 

Alphanumeric 

String 

Account currency (USD, GBP, EUR, etc...). 

balance 

Numeric 

For main account: returns the account's remaining balance. 

For sub-account: returns the account's remaining limit bal¬ 
ance of the day if a daily limit is fixed. Else, returns the ac¬ 
count remaining balance. 
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Name 

Type 

Description 

wallet 

Numeric 

For main account: returns the total remaining balance (sum 
of all sub-accounts and current master). 

For sub-account: 



1 . 

If balance is shared and daily limit is fixed: returns the 
fixed daily limit amount 



2. 

If balance is shared but daily limit is not fixed: 

returns "No Limit" 



3. 

Else if balance is not shared: 




returns the remaining balance 


Sample 1 - Master account 
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Request 

<xml> 

<login>demo</login> 

<key>1326958538</key> 

<md5>your MD5 here</md5> 

<action>check_wallet</action> 

</xml> 

Response 

<TransferTo> 

<type>Master</type> 

<name>demo</name> 

<currency>USD</currency> 

<balance>5.99</balance> < - Current balance of master account. 

<wallet>9.99</wallet> ^- Total balance of master and sub-accounts. 

<authentication_key>1326958538</authentication_key> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 

</TransferTo> 
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Sample 2 - Sub-Account - Shared Balance - Daily Limit Fixed to 1 


Retrieve sub-account balance 
and Daily limit 

demob 2 .00 

Add or Withdraw 

demo (Master Account) 5.99 

demoa 2.00 

Add or Withdraw 


Login Name 


Balance 


Manage Funds 
or Daily Limit[?] 


democ 


Shared 


1 0 ) 


Request 

<xml> 

<login>democ</login> 

<key>1326958538</key> 

<md5>your MD5 here</md5> 

<action>check_wallet</action> 

</xml> 

Response 

<TransferTo> 

<type>Retailer</type> 

<name>democ</name> 

<currency>USD</currency> 

<balance>i.oo</balance> ◄- Current balance of sub-account (daily remaining balance). 

<wallet>i.oo</wallet> < - Daily limit of sub-account. 

<authentication_key>1326958689</authentication_key> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 

</TransferTo> 
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Sample 3 - Sub-Account - Shared Balance - No Daily Limit 

Request 

<xml> 

<login>testingl</login> 

<key>1326958538</key> 

<md5>your MD5 here</md5> 

<action>check_wallet</action> 

</xml> 

Response 

<TransferTo> 

<type>Retailer</type> 

<name>testingl</name> 

<currency>USD</currency> 

<balance>1.00</balance> 

<wallet>No Limit</wallet> 

<authentication_key>1326958689</authentication_key> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 

</TransferTo> 
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Sample 4 - Sub-Account - No Shared Balance 


Login Name 


Balance Manage Funds 
or Daily Limit[?] 


democ 


Shared 1 (1) 


Balance of sub-account 


demoa 


demob 


demo (Master Account) 5.99 


2.00 


2.00 



Daily Limit Not Applicable 


Add or Withdraw 


Request 

<xml> 

<login>demoa</login> 

<key>1326958538</key> 

<md5>your MD5 here</md5> 

<action>check_wallet</action> 

</xml> 

Response 

<TransferTo> 

<type>Retailer</type> 

<name>demoa</name> 

<currency>USD</currency> 

<balance>2.oo</baiance> " Current balance of sub-account 



<wallet>2.00</wallet> 

<authentication_key>1326958689</authentication_key> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 
</TransferTo> 
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7.2 Get the list of countries offered to my account 

Purpose Get the following list 


Select a destination: 

Afghanistan - Albania - Anguilla - Antigua and Barbuda - Argentina ■ Armenia - Aruba - Bangladesh - Barbados - Benin ■ Bolivia - Brazil - British 
Virgin Islands - Burkina Faso - Burundi - Cambodia - Cameroon - Cayman Islands - Central African Republic - Chile - China - Colombia - Congo - Costa 
Rica - Cuba - Cyprus - Democratic Republic of the Congo - Dominica - Dominican Republic - Ecuador - Egypt - Q Salvador - Fiji - France - Gambia - 
Ghana - Grenada - Guatemala - Guinea - Guinea Bissau - Guyana - Haiti - Honduras - India - Indonesia - Iraq - Ivory Coast - Jamaica - Jordan - 
Kazakhstan - Kenya - Laos - Liberia - Madagascar - Malaysia • Mali - Mexico • Moldova - Montserrat - Morocco - Mozambique - Nauru - Nepal - 
Nicaragua - Niger - Nigeria - Pakistan - Palestine • Panama - Papua New Guinea - Paraguay - Peru - Philippines - Poland - Puerto Rico - Romania - 
Russia - Rwanda - Samoa - Senegal - Sierra Leone - Singapore - Somalia - South Africa - Spain - Sri Lanka - St Kitts and Nevis - St Lucia - St Vincent 
Grenadines - Sudan - Suriname - Swaziland - Syria - Tanzania - Thailand - Togo - Tonga - Trinidad and Tobago - Tunisia - Turkey - Turks and Caicos 
- Uganda - Ukraine • United States - Uruguay - Vanuatu - Vietnam - Yemen • Zambia - Zimbabwe • all 


Method pricelist 

Returns the list of countries offered to your account when request is sent with "countries" in argument 
(see above). 


Request Parameters 


Name 

Type 

Required 

(Yes/No) 

Description 

login 

Alphanumeric 

String 

Y 

Account login name provided by TransferTo. 

key 

Integer 

Y 

Key generated by the client. The transaction is rejected if 
the key has been used. 

md5 

Alphanumeric 

String 

Y 

MD5 sum of the hex encoded concatenation of login, to¬ 
ken, and key. 

action 

Alphanumeric 

String 

Y 

Must be set to "pricelist" 

info_type 

Alphanumeric 

String 

Y 

Must be set to "countries" to return the list of all countries 

offered to the account name defined in login parameter. 


TransferTo Inc. - Cross-Border Mobile Payments 
© Copyright 2016 - Confidential 



















Airtime API Document 
Version No. 2.8.3 



TransferTo 


Response Parameters 


Name 

Type 

Description 

authentication_key 

Integer 

Key generated by the client to perform the request (speci¬ 
fied in key request parameter). The transaction is rejected if 
the key has been used. 

error_code 

Integer 

Error code of the transaction. Refer to section 9.0 to see the 

list of error codes returned by the API. 

error_txt 

Alphanumeric 

String 

Description of the error. 

country 

Alphanumeric 

String 

List of countries offered. 

countryid 

Integer 

List of respective unique ID of countries listed in parameter 
"country". 


Sample Request 

<xml> 

<login>your_login</login> 

<key>1326965217</key> 

<md5>md5</md5> 

<info_type>countries</info_type> 

<action>pricelist</action> 

</xml> 


Sample Response 

<TransferTo> 

<country>Afghanistan,Albania,Anguilla,Antigua and Barbuda,Argentina,Armenia,Aruba</country> 
<countryid>661,662,916,668,669,670,671</countryid> 

<authentication_key>1337662098</authentication_key> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 

</TransferTo> 
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7.3 Get the list of operators for a given country 


Purpose Send a country ID to get the list of operators offered in this destination 


Select a destination: 

Afghanistan - Albania - Anguilla - Antigua and Barbuda - Argentina - Armenia - Aruba - Bangladesh - Barbados - Benin - Bolivia - Brazil - British Virgin Islands - 
Burkina Faso - Burundi - Cambodia - Cameroon - Cayman Islands - Central African Republic - Chile - China - Colombia - Congo - Costa Rica - Cuba - Cyprus - 
Democratic Republic of the Congo - Dominica - Dominican Republic - Ecu ador - Egypt - El Salvador - Fiji - France - Gambia - Ghana - Grenada - Guatemala - 
Guinea - Guinea Bissau - Guyana - Haiti - Honduras - India -| Indonesia -| Iraq - Ivory Coast - Jamaica - Jordan - Kazakhstan - Kenya - Laos - Liberia - 
AAadagascar - Malaysia - Mali - Mexico - Moldova - Montserrat - Morocco - Mozambique - Nauru - Nepal - Nicaragua - Niger - Nigeria - Pakistan - Palestine - 
Panama - Papua New Guinea - Paraguay - Peru - Philippines - Poland - Puerto Rico - Romania - Russia - Rwanda - Samoa - Senegal - Sierra Leone - Singapore 
- Somalia - South Africa - Spain - Sri Lanka - St Kitts and Nevis - St Lucia - St Vincent Grenadines - Sudan - Suriname - Swaziland - Syria - Tanzania - 
Thailand - Togo - Tonga - Trinidad and Tobago - Tunisia - Turkey - Turks and Caicos - Uganda - Ukraine - United States - Uruguay - Vanuatu - Vietnam - 
Yemen - Zambia - Zimbabwe - all 


Download products for: Indonesia • All Countries 


Country 

Operator 

Denomination 

Your Buying Price 

Selling Price Your Margin [?] 

Transaction Fee [?] 

Status 





Reset all 


Reset all 


Reset all 

Indonesia (+62) 

AAA-TESTING Indonesia USD (1562) 

USD 1 

USD 0.03 

USD 0.10 

70.00 % 

0.00 


Live 

TransferTo 

USD 2 

USD 0.03 

USD 0.10 

70.00% 

0.00 


Live 



USD 3 

USD 0.03 

USD 0.10 

70.00 % 

0.00 


Live 



USD 5 

USD 0.03 

USD 0.10 

70.00% 

0.00 


Live 



USD 10 

USD 0.03 

USD 0.10 

70.00% 

0.00 


Live 

Country 

Operator 

Denomination 

Your Buying Price 

Selling Price Your Margin [?] 

Transaction Fee [?] 

Status 





Reset all 


Reset all 


Reset all 

Indonesia (+62) 

Axis Indonesia (1411) 

IDR 5000 

USD 0.85 

USD 1.00 

15.00% 

0.00 


Live 


AXIS# 

IDR 10000 

USD 1.28 

USD 1.50 

14.67% 

0.00 


Live 



IDR 25000 

USD 2.98 

USD 3.50 

14.86% 

0.00 


Live 



IDR 50000 

USD 5.53 

USD 6.50 

14.92% 

0.00 


Live 



IDR 100000 

USD 11.05 

USD 13.00 

15.00% 

0.00 


Live 

Country 

Operator 

Denomination 

Your Buying Price 

Selling Price Your Margin [?] 

Transaction Fee [?] 

Status 





Reset all 


Reset all 


Reset all 

Indonesia (+62) 

Ceria Indonesia (1839) 

IDR 5000 

USD 0.60 

USD 0.70 

14.29% 

0.00 


Live 


Ceria 

IDR 10000 

USD 1.16 

USD 1.35 

14.07% 

0.00 


Live 


JMM 

IDR 20000 

USD 2.27 

USD 2.66 

14.66% 

0.00 


Live 



IDR 50000 

USD 5.62 

USD 6.57 

14.46% 

0.00 


Live 



IDR 100000 

USD 11.19 

USD 13.10 

14.58% 

0.00 


Live 

Country 

Operator 

Denomination 

Your Buying Price 

Selling Price Your Margin [?] 

Transaction Fee [?] 

Status 





Reset all 


Reset all 


Reset all 

Indonesia (+62) 

Esia Bakrie Telecom Indonesia (1326) 

IDR 5000 

USD 0.85 

USD 1.00 

15.00% 

0.00 


Live 


% esia 

IDR 10000 

USD 1.28 

USD 1.50 

14.67% 

0.00 

1 

0 



IDR 25000 

USD 2.98 

USD 3.50 

14.86% 

0.00 

on site on page 



IDR 50000 

USD 5.53 

USD 6.50 

14.92% 

0.00 

OMtyWit walycts X 


Method pricelist 

Returns the list of operators offered to your account, for a specific country, when request is sent with 
"countryid" in argument (see above). 
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Request Parameters 


Name 

Type 

Required 

(Yes/No) 

Description 

login 

Alphanumeric 

String 

Y 

Account login name provided by TransferTo. 

key 

Integer 

Y 

Key generated by the client. The transaction is rejected if 
the key has been used. 

md5 

Alphanumeric 

String 

Y 

MD5 sum of the hex encoded concatenation of login, to¬ 
ken, and key. 

action 

Alphanumeric 

String 

Y 

Must be set to "pricelist" 

info_type 

Alphanumeric 

String 

Y 

Must be set to "country" to return the list of operators 
available in the given country. 

content 

Integer 

Y 

This parameter is related to info_type: defines the coun- 
tryid for which the operator list is requested. 


Response Parameters 


Name 

Type 

Description 

authentication_key 

Integer 

Key generated by the client to perform the request (speci¬ 
fied in key request parameter). The transaction is rejected if 
the key has been used. 

error_code 

Integer 

Error code of the transaction. Refer to section 9.0 to see the 

list of error codes returned by the API. 

error_txt 

Alphanumeric 

String 

Description of the error. 

country 

Alphanumeric 

String 

Country requested. 

countryid 

Integer 

Unique ID of the requested country. 

operator 

Alphanumeric 

String 

List of destination operators offered. 

operatorid 

Integer 

List of respective unique operators ID of operator listed in 
parameter "operator". 
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Sample Request 


<xml> 

<login>your_login</login> 

<key>1326965217</key> 

<md5>md5</md5> 

<info_type>country</info_type> 

<content>767</content> 

<action>pricelist</action> 

</xml> 


Specify the country ID from which you request 
operator list. 


Sample Response 

<xml> 

<country>lndonesia</country> 

<countryid>767</countryid> 

<operator>lndosat Starone Indonesia,Telkom Flexi Indonesia,Indosat IM3 Indonesia,AAA-TESTING Indone¬ 
sia,Esia Bakrie Telecom Indonesia,Indosat Mentari Indonesia,Telkomsel Simpati Indonesia,Three Telecom 
Indonesia,Telkomsel KartuAS Indonesia,Excelcom Indonesia,Axis lndonesia</operator> 

<operatorid>1320,1322,1313,1310,1326,1312,1324,1327,1325,215,1411</operatorid> 
<authentication_key>1337662386</authentication_key> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 

</xml> 
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7.4 Get the list of products for a given operator 

Purpose Send an operator ID to get the list of denomimation as well as wholesale and 

retail prices. 


Country Operator 

Denomination 

Your Buying Price 

Selling Price 




Reset all 

Indonesia (+62) Indosat IM3 Indonesia (1313) 

IDR 5000 

USD 0.85 

USD 1.00 

£ 

IDR 10000 

USD 1.28 

USD 1.50 

SuEJ 

IDR 25000 

USD 2.98 

USD 3.50 


IDR 50000 

USD 5.53 

USD 6.50 


IDR 100000 

USD 11.05 

USD 13.00 


Method pricelist 

Returns the list of denomination including wholesale and retail prices offered to your account, for a spe¬ 
cific operator, when request is sent with "operatorid" in argument (see above). 


Request Parameters 


Name 

Type 

Required 

(Yes/No) 

Description 

login 

Alphanumeric 

String 

Y 

Account login name provided by TransferTo. 

key 

Integer 

Y 

Key generated by the client. The transaction is rejected if 
the key has been used. 

md5 

Alphanumeric 

String 

Y 

MD5 sum of the hex encoded concatenation of login, to¬ 
ken, and key. 

action 

Alphanumeric 

String 

Y 

Must be set to "pricelist" 

info_type 

Alphanumeric 

String 

Y 

Must be set to "operator" to return the list of wholesale 
and retail prices available for the given operator. 

content 

Integer 

Y 

This parameter is related to info_type: defines the opera¬ 
torid for which the prices lists are requested. 
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Response Parameters 


Name 

Type 

Description 

authentication_key 

Integer 

Key generated by the client to perform the request (speci¬ 
fied in key request parameter). The transaction is rejected if 
the key has been used. 

error_code 

Integer 

Error code of the transaction. Refer to section 9.0 to see the 

list of error codes returned by the API. 

error_txt 

Alphanumeric 

String 

Description of the error. 

country 

Alphanumeric 

String 

Country of the requested operator. 

countryid 

Integer 

Unique ID of the country. 

operator 

Alphanumeric 

String 

Operator requested. 

operatorid 

Integer 

Unique ID of the operator. 

destination_currency 

Alphanumeric 

String 

Currency of the destination country. 

productjist 

String 

Returns the list of all available products configured for the 
current account and the given operator. 

Products are separated by a comma. 

retail_price_list 

String 

Returns the list of all final retail prices configured for the 
current account and the given operator. 

Prices are separated by a comma and in the currency of the 

current account. 

wholesale_price_list 

String 

Returns the wholesale price (also known as Your Cost) list of 
all available products configured for the current account 
and the given operator. 

Prices are separated by a comma and in the currency of the 

current account. 
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Country 

Operator 


Denomination 

Your Buying Price 

Selling Price 






Reset all 

Indonesia (+62) 

Indosat IM3 Indonesia (1313) 


IDR 5000 

USD 0.85 

USD 1.00 


<£ 


IDR 10000 

USD 1.28 

USD 1.50 


fTHWI 


IDR 25000 

USD 2.98 

USD 3.50 




IDR 50000 

USD 5.53 

USD 6.50 




IDR 100000 

USD 11.05 

USD 13.00 


Sample Request 


<xml> 

<login>your_login</login> 

<key>1326965217</key> 

<md5>md5</md5> 

<info_type>operator</info_type> 

<content>1313</content> 

<action>pricelist</action> 

</xml> 


Specify the operator ID from which you request 
price list. 


Sample Response 

<xml> 

<country>lndonesia</country> 

<countryid>767</countryid> 

<operator>lndosat IM3 lndonesia</operator> 

<operatorid>1313</operatorid> 

<destination_currency>IDR</destination_currency> 

<product_list>5000,10000,20000,25000,50000,100000</product_list> 

<wholesale_price_list>0.85,l.28,2.98,5.53,11.05</wholesale_price_list> 

<retail_pricejist>1.00,1.50,3.50,6.50,13.00</retail_price_list> 

<authentication_key>1337662386</authentication_key> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 

</TransferTo> 
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8.0 Reports: Transaction Information Query 


In this section, you will find the following information: 

• How to retrieve information on a transaction from an ID 

• How to retrieve a list of transaction performed during a given date range 

• How to retrieve a transaction ID from the unique key used during the transaction query 

8.1 Get information from a transaction ID 


Purpose 


Get destination phone number, topup amount, retail price, etc. 


Search Transaction 

Sender No: Recipient No: 


Export report to csv 

TrxID Date User 

188609730 11 Jun, 2014 17:36 


Transaction ID: 188609730 



Account Operator 


Amount Status Retail Price 
_ (USD) 


AAA-TESTING Indonesia USD 


628123456770 USD 1 


Method trans_info 

Returns all available information on a specific transaction ID. 

Please note that this method is useless if called just after topup request. First because it can take time to 
update database. Besides, the topup response provides the same information. 


Request Parameters 


Name 

Type 

Required 

(Yes/No) 

Description 

login 

Alphanumeric 

String 

Y 

Account login name provided by TransferTo. 

key 

Integer 

Y 

Key generated by the client. The transaction 
is rejected if the key has been used. 

md5 

Alphanumeric 

String 

Y 

MD5 sum of the hex encoded concatenation 

of login, token, and key. 

action 

Alphanumeric 

String 

Y 

Must be set to "transjnfo" 

transactionid 

Integer 

Y 

ID of the transaction which requires infor¬ 
mation. 
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Response Parameters 


8.1.1 PIN Less 


Name 

Type 

Description 

transactionid 

Integer 

Defines the ID of the transaction. 

msisdn 

Alphanumeric 

String 

The international phone number or name of 
the user (sender) requesting to credit a phone 

number. 

destination_msisdn 

Numeric String 

Destination MSISDN (usually recipient phone 
number). 

transaction_authentication_key 

Integer 

Authentication key used during the transac¬ 
tion. 

transaction_error_code 

Integer 

Error code linked to the transaction ID speci¬ 
fied in the request. 

transaction_error_txt 

Alphanumeric 

String 

Description of the error linked to the transac¬ 
tion ID specified in the request. 

country 

Alphanumeric 

String 

Country of the destination operator. 

countryid 

Integer 

Unique ID of the destination country. 

operator 

Alphanumeric 

String 

Destination operator name. 

operatorid 

Integer 

Destination operator ID returned only if forced 
by client, else blank. 

reference_operator 

Alphanumeric 

String 

Reference of the operator (returned only if 
available). 

product_requested 

Float 

Value of the product defined in "product" field 
of the topup request. 

actual_product_sent 

Float 

Returns the value requested to the operator 
(equals to product_requested in case of suc¬ 
cessful transaction). It equals to 0 when Top-up 

failed. 

wholesale_price 

Numeric 

Returns the cost of the product defined in 
"product" field of the request. This cost is set 
in the account's currency. 

retail_price 

Numeric 

Returns the retail price of the product as con¬ 
figured in the account. 
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Name 

Type 

Description 

sms 

Alphanumeric 

String 

Recipient SMS 

Returns the custom message appended to the 
default notification SMS sent to the recipient. 

cidl 

Alphanumeric 

String 

Value of the customized field cidl sent in the 

Top-up request. 

cid2 

Alphanumeric 

String 

Value of the customized field cid2 sent in the 

Top-up request. 

cid3 

Alphanumeric 

String 

Value of the customized field cid3 sent in the 

Top-up request. 

date 

String 

Date of the transaction (GMT). 

originating currency 

Alphanumeric 

String 

Currency of the account from which the trans¬ 
action is requested. 

destination_currency 

Alphanumeric 

String 

Currency of the destination country. 

pin_based 

String 

Type of product returned ("Yes", default "No" 
if not set). 

local_info_amount 

Numeric 

Final amount received by recipient. Indicative 
value only. 

local_info_currency 

Alphanumeric 

String 

Local currency in destination 

local_info_value 

Numeric 

Value of this transaction before tax and service 

fee in local currency. 

authentication_key 

Integer 

Key generated by the client to perform the re¬ 
quest (specified in key request parameter). The 
transaction is rejected if the key has been used. 

error_code 

Integer 

Error code of the transaction. Refer to section 

10 to see the list of error codes returned by the 

API. 

error_txt 

Alphanumeric 

String 

Description of the error. 
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Sample Request 

<xml> 

<login>your_login</login> 

<key>1326967613</key> 

<md5>md5</md5> 

<transactionid>188609730</transactionid> 

<action>trans_info</action> 

</xml> 
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Sample Response 


Trx ID 

Date(UTC) 

Tag User 

Sender 

Dest No. 

Operator 

Amt 

Status cidl cid2 cid3 

Retail 

Price 

Wholesale 

Price 

Fee 

188609730 

11Jun2014 


a friend 

628123456770 

AAA-TESTING 

1.00 

0 

0.00 

0.03 

0.00 


17:36 




Indonesia USD 







<TransferTo> 

<transactionid>188609730</transactionid> 

<msisdn>69999999999</msisdn> 
<destination_msisdn>628123456770</destination_msisdn> 
<transaction_authentication_key>1326963417</transaction_authentication_key> 

<transaction_error_code>0</transaction_error_code> 
<transaction_error_txt>Transaction successful</transaction_error_txt> 
<country>lndonesia</country> 

<countryid>767</countryid> 

<operator>AAA-TESTING lndonesia</operator> 

<operatorid>0</operatorid> 

<reference_operator>HASH(0xl343f70)</reference_operator> 

<product_requested>1.00</product_requested> 

<actual_product_sent>1.00</actual_product_sent> 

<wholesale_price>0.03</wholesale_price> 

<retail_price>0.00</retail_price> 

<sms>Tshop test from me</sms> 

<cidlx/cidl> 

<cid2x/cid2> 

<cid3x/cid3> 

<date>2014-06-ll 17:36:21.326342</date> 

<originating_currency>USD</originating_currency> 

<destination_currency>IDR</destination_currency> 

<authentication_key>1326967613</authentication_key> 

<pin_based>no</pin_based> 

<local_info_amount>l</local_info_amount> 

<local_info_currency>IDR</local_info_currency> 

<local_info_value>l</local_info_value> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 

</TransferTo> 


Key used to perform 
the transaction 
188609730 . 
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8.1.2 PIN Based 

Response Parameters (additional parameters applicable to PIN Based only) 


Name 

Type 

Description 

pin_based 

String 

Returns "Yes" if PIN-based transactions. Else "No". 

pin_validity 

String 

Validity of the PIN. 

pin_code 

Alphanumeric 

String 

Code of the PIN. 

pinjvr 

Integer 

IVR number of the PIN. 

pin_serial 

Alphanumeric 

String 

Serial number of the PIN. 

pin_value 

Integer 

Value of the PIN. 

pin_option_l 

String 

Additional information. For example, it can describe how to use 
the PIN directly from handset (by entering a dedicated USSD 
code). 

pin_option_2 

String 

Additional information. For example, it can provide the opera¬ 
tor refill website. 

pin_option_3 

String 

Additional information. For example, it can provide the opera¬ 
tor refill call center. 


Sample Request 

<xml> 

<login>your_login</login> 

<key>1326968024</key> 

<md5>md5</md5> 

<transactionid>77749654</transactionid> 

<action>trans_info</action> 

</xml> 
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Sample Response 

<TransferTo> 

<transactionid>77749654</transactionid> 

<msisdn>69999999999</msisdn> 

<destination_msisdn>9779742045269</destination_msisdn> 

<transaction_authentication_key>1326964272</transaction_authentication_key> 

<transaction_error_code>0</transaction_error_code> 

<transaction_error_txt>Transaction successful</transaction_error_txt> 

<country>Nepal</country> 

<countryid>819</countryid> 

<operator>NTC CDMA Nepal</operator> 

<operatorid>0</operatorid> 

<reference_operatorx/reference_operator> 

<product_requested>200</product_requested> 

<actual_product_sent>200</actual_product_sent> 

<wholesale_price>2.58</wholesale_price> 

<retail_price>3.30</retail_price> 

<sms>Free credit from TransferTo</sms> 

<cidlx/cidl> 

<cid2x/cid2> 

<cid3x/cid3> 

<date>2012-01-19 09:ll:13.792268</date> 

<originating_currency>USD</originating_currency> 

<destination_currency>NPR</destination_currency> 

<pin_based>yes</pin_based> 

<pin_value>200</pin_value> 

<pin_code>12345678901234</pin_code> 

<pin_ivr>1415</pin_ivr> 

<pin_serial>123456789123456789</pin_serial> 

<pin_validity>2014-01-18T00:00:00+05:45</pin_validity> 

<pin_option_l>To recharge your mobile, dial 1415 from your own Pre-Paid mobile phone and follow the in¬ 
structions.</pin_option_l> 

<pin_option_2>SkyPhone</pin_option_2> 

<pin_option_3x/pin_option_3> 

<localjnfo_amount>2.80</local_info_amount> 

<local_info_currency>NPR</local_info_currency> 

<local_info_value>2.80</local_info_value> 

<authentication_key>1326968024</authentication_key> 

<error_code>0</error_code> 

<error_txt>Transaction successful</error_txt> 

</TransferTo> 
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8.2 Get the list of transactions performed during a given date range 

Method trans list 


Returns the list of transactions performed during a given date range. 


Request Parameters 


Name 

Type 

Required 

(Yes/No) 

Description 

login 

Alphanumeric 

String 

Y 

Account login name provided by TransferTo. 

key 

Integer 

Y 

Key generated by the client. The transaction 
is rejected if the key has been used. 

md5 

Alphanumeric 

String 

Y 

MD5 sum of the hex encoded concatenation 

of login, token, and key. 

action 

Alphanumeric 

String 

Y 

Must be set to "transjist" 

destination_msisdn 

Numeric String 

N 

Destination MSISDN (usually recipient 
phone number). 

This is the destination phone number that 

will be credited with the amount trans¬ 
ferred. Format is similar to "msisdn" and re¬ 
stricted to international phone number on- 

ly. 

msisdn 

Alphanumeric 

String 

N 

The international phone number or name of 
the user requesting to credit a phone num¬ 
ber (sender phone number). The format 
must contain the country code, and will be 
valid with or without the '+' or 'OCT placed 
before it. For example: "6012345678" or 
"+6012345678" or "006012345678" (Malay¬ 
sia) or "John" are all valid. This field must 
not be empty. 

code 

Numeric String 

N 

The error_code of the transactions to 
search for. E.g "0" to search for only all suc¬ 
cessful transactions. If left empty, all trans¬ 
actions will be returned (Failed and success¬ 
ful). 
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Name 

Type 

Required 

(Yes/No) 

Description 

start_date 

String 

Y 

Defines the start date of the search (includ¬ 
ed). 

Format must be YYYY-MM-DD. 

stop_date 

String 

Y 

Defines the end date of the search (includ¬ 
ed). 

Format must be YYYY-MM-DD. 


Response Parameters 


Name 

Type 

Description 

authentication_key 

Integer 

Key generated by the client to perform the request (speci¬ 
fied in key request parameter). The transaction is rejected if 
the key has been used. 

error_code 

Integer 

Error code of the transaction. Refer to section 9.0 to see the 

list of error codes returned by the API. 

error_txt 

Alphanumeric 

String 

Description of the error. 

status_code 

Integer 

Transaction status. 

0 will be returned in case of successful transaction. 

Deprecated, use field "error_code" instead. 

transaction_list 

String 

List of transaction IDs found based on search parameters 
(date range and MSISDN). 

Transactions are separated by a comma. 


Sample Request 


<xml> 

<login>your_login</login> 

<key>1217301496240</key> 

<md5>14dla9f386479b2af4d62a8f932f5d79</md5> 

<msisdn>6598236911</msisdn> 

<destination_msisdn>628123456770</destination_msisdn> 

<code>0</code> 

<start_date>2008-01-01</start_date> _ 

<stop_date>2008-08-01</stop_date> 

<action>trans_list</action> 

</xml> 



Refine the research by 
specifying Sender 
or/and Recipient Phone 


Define the date range 
(mandatory parameters). 
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Sample Response 

<TransferTo> 

<status_code>0</status_code> 

<transaction_list>6115,6137,6183,6184,6204,6514,8129,8135,14888,14891</transaction_list> 
<error_txt>Transaction successful</error_txt> 
<authentication_key>1217301496240</authentication_key> 

<error_code>0</error_code> 

</TransferTo> 
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8.3 Get a transaction ID from a given key 

Method get_id_from_key 

Returns the ID of a transaction previously performed based on the key used in the request at that time. 


Request Parameters 


Name 

Type 

Required 

(Yes/No) 

Description 

login 

Alphanumeric 

String 

Y 

Account login name provided by TransferTo. 

key 

Integer 

Y 

Key generated by the client. The transaction 
is rejected if the key has been used. 

md5 

Alphanumeric 

String 

Y 

MD5 sum of the hex encoded concatenation 

of login, token, and key. 

action 

Alphanumeric 

String 

Y 

Must be set to "get_id_from_key" 

from_key 

Integer 

Y 

Key used during a transaction previously 
performed, whom ID is requested. 


Response Parameters 


Name 

Type 

Description 

authentication_key 

Integer 

Key generated by the client to perform the request (speci¬ 
fied in key request parameter). The transaction is rejected if 
the key has been used. 

error_code 

Integer 

Error code of the transaction. Refer to section 9.0 to see the 

list of error codes returned by the API. 

error_txt 

Alphanumeric 

String 

Description of the error. 

from_key 

Integer 

Key used during a transaction previously performed, whom 

ID is requested (same as the one specified in from_key re¬ 
quest parameter). 

id 

Integer 

ID of the transaction you were looking for. Blank if not 

found 
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Sample Request 

<xml> 

<login>your_login</login> 

<key>1217303174266</key> 

<md5>b70aa58d2fe87d0bb0cd2bl902e5fce2</md5> 

<from_key>i 334909705 </from_key> < - Key used during the transaction. 

<action>get_id_from_key</action> 

</xml> 


Sample Response 

<TransferTo> 

<error_txt>Transaction successful</error_txt> 
<authentication_key>1217303174266</authentication_key> 

<error_code>0</error_code> 

<id> 765432 i</id> ◄- Transaction ID linked to the given Key . 

</TransferTo> 


TransferTo Inc. - Cross-Border Mobile Payments 
© Copyright 2016 - Confidential 







Airtime API Document 
Version No. 2.8.3 



TransferTo 


9.0 Standard API Errors 


Code 

Text 

Description 

0 

Transaction successful. 

Indicates the Top-up was successfully delivered to the recipient. 

101 

Destination MSISDN out of range 

Numbering plan not recognized: the destination/recipient number 
was not identified as to belonging to any operators covered by Trans¬ 
ferTo. 

Re-check recipient number and/or escalate the case to the TransferTo 
Support Team for further investigation. 

104 

MSISDN in blacklist 

Here MSISDN refers to both sender and recipient phone numbers 

which are blacklisted due to fraudulent activities. 

105 

Not enough credit on your account 

Transaction failed due to insufficient funds in your account's prepaid 
balance. Please reload balance and try again. 

200 

Transaction canceled by Customer 


202 

Transaction canceled by TransferTo 


203 

Transaction incomplete 

Transaction failed due to a technical issue. 

Please contact TransferTo Support Team for further investigation. 

204 

Destination Account is not prepaid or 

not valid 

Transaction refused by the operator because the recipient phone 
number is not a valid prepaid account. 

207 

Transaction amount limit exceeded 

Here limit refers to maximum amount defined for the destination 

MSISDN. There are some limitations set on the operator's side, not 

controlled by TransferTo. When one of these limits is reached, error 

code 207 will be returned. 

Some examples: 

• Indosat Indonesia operator's end, the customer must wait at least 

5 mins before sending another transfer to the same recipient ac¬ 
count. 

• Indian operators' end, the customer must wait 3 mins before 
sending another transfer of the same amount to the same recipi¬ 
ent account. 

• Orange Africa, the recipient account is limited to a maximum re¬ 
chargeable amount of 30 Euros per week and 60 Euros per 
month. 

213 

Repeated transaction 

Transaction refused because it was submitted too closely after a pre¬ 
ceding Top-up attempt. 

214 

Topup refused 

Transaction refused by the operator for a reason that was not 
specified. 

Common reasons for these types of failures are: 

• Recipient number not valid for recharge. 

• Service outage temporarily faced on the operator. 

Please try again at a later time and/or contact the TransferTo 
Support Team if the problem persists. 
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Code 

Text 

Description 

215 

Service to this destination operator 
is temporarily unavailable 

Transaction failed due to an outage and/or connection issue 
with the operator. 

Please try again at a later time and/or contact the TransferTo 
Support Team if the problem persists. 

216 

Destination number not activated 

Transaction refused by the operator because the recipient 

number has not been activated. 

217 

Destination number expired 

Transaction refused by the operator because the recipient 
number is no longer an active account. 

218 

Request timeout 

Transaction timed-out and failed because of the long pro¬ 
cessing duration. 

Please try again at a later time and/or contact the TransferTo 
Support Team if the problem persists. 

219 

Key does not exist 

Request failed because the key provided does not exist (error 
returned for get_id_from_key method requests only). 

221 

Fraud suspicion 

Transaction refused and the recipient number flagged for sus¬ 
picion of fraud, due to the number of consecutive Top-up re¬ 
quests within a short gap of time. 

The recipient phone number will be locked out from receiving 
any Top-up for a certain period of time, after which, the re¬ 
striction will be automatically released. 

222 

Number barred from refill 

This error code is returned when the recipient has been 
blocked from refill directly by the recipient's operator. It pre¬ 
vents TransferTo system from reloading his account. 

Recipient must call the operator's customer service to unblock 

it 

223 

ID not reserved 

Transaction failed because the transaction ID specified in the 
request was not previously reserved. 

224 

Invalid length of destination 

MSISDN 

Transaction failed because the recipient number length does 
not match (shorter or longer) the mobile number format of the 

country. 

230 

Recipient reached maximum topup 

number 

This error is returned when a recipient reaches the maximum 
number of Top-up allowable in a certain gap of time. 

• 01 Day(s) => 10 

• 07 Day(s) => 15 

• 30Day(s)=>40 
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Code 

Text 

Description 

231 

Recipient reached maximum topup 

amount 

This error is returned when a recipient reaches the maximum 
amount (in USD) of Top-up allowable in a certain gap of time. 

• 01 Day(s) => max 100 USD 

• 07 Day(s) => max 150 USD 

• 30 Day(s) => max 200 USD 

232 

Account reached maximum topup 

number 

This error is returned when your account has reached its max¬ 
imum number of Top-up allowable in a certain gap of time. 

233 

Account reached maximum topup 

amount 

This error is returned when your account has reached its max¬ 
imum amount (in USD) of Top-up allowable in a certain gap of 

time. 

241 

Account reached maximum daily 

topup amount 

This error is returned when your account has reached its max¬ 
imum amount (in USD) of Top-up allowable within a day. 

242 

Account reached maximum daily 
topup number 

This error is returned when your account has reached its max¬ 
imum number of Top-up allowable within a day. 

243 

Account reached maximum weekly 

topup amount 

This error is returned when your account has reached its max¬ 
imum amount (in USD) of Top-up allowable within a week. 

244 

Account reached maximum weekly 
topup number 

This error is returned when your account has reached its max¬ 
imum number of Top-up allowable within a week. 

245 

Account reached maximum month¬ 
ly topup amount 

This error is returned when your account has reached its max¬ 
imum amount (in USD) of Top-up allowable within a month. 

246 

Account reached maximum month¬ 
ly topup number 

This error is returned when your account has reached its max¬ 
imum number of Top-up allowable within a month. 

251 

Sender reached maximum daily 
topup amount 

This error is returned when the sender has reached its maxi¬ 
mum amount (in USD) of Top-up allowable within a day. 

252 

Sender reached maximum daily 
topup number 

This error is returned when the sender has reached its maxi¬ 
mum number of Top-up allowable within a day. 

253 

Sender reached maximum weekly 
topup amount 

This error is returned when the sender has reached its maxi¬ 
mum amount (in USD) of Top-up allowable within a week. 

254 

Sender reached maximum weekly 
topup number 

This error is returned when the sender has reached its maxi¬ 
mum number of Top-up allowable within a week. 

255 

Sender reached maximum monthly 
topup amount 

This error is returned when the sender has reached its maxi¬ 
mum amount (in USD) of Top-up allowable within a month. 

256 

Sender reached maximum monthly 
topup number 

This error is returned when the sender has reached its maxi¬ 
mum number of Top-up allowable within a day month. 

301 

Denomination not available 

Denomination not available for this destination. 
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Code 

Text 

Description 

310 

Denomination blocked 

Transaction failed because the Top-up is no longer available on 
the operator's offer or on the account. 

311 

Operator blocked 

Transaction failed because the Top-up is no longer available on 

the account. 

312 

Operator blocked by customer 

Transaction failed because operator have been blocked explic- 
itely in customer account. 

320 

Requested amount out of range 

Transaction failed because the Top-amount request was not 
within the range of valid amounts. 

321 

Requested currency not allowed 

for this account 

Transaction failed because the currency specified is not valid 

for the account. 

401 

Transaction ID not found or was 

not made by your account 

No transaction was found with the ID specified (error returned 
for transjnfo method requests only). 

777 

Insufficient balance in your master 

account 

Transaction failed because there are not enough funds in your 

master account. 

888 

Insufficient balance in your sub¬ 
account 

Transaction failed because there are not enough funds in your 

sub-account. 

900 

Not enough information to process 
the topup 

Transaction failed because some of the required fields in your 
Top-up request are missing/empty. 

901 

Invalid action 

Transaction failed because the action specified in <action> 
field of the request is not valid. 

902 

Invalid input_currency 


903 

Invalid output_currency 


904 

Invalid input_value 


905 

Invalid start_date 


906 

Invalid stop_date 


907 

Invalid transaction ID 

Transaction ID specified in the <reserved_id> of the Top-up 
request is not valid. 

908 

Account not configured for this 

service 

Transaction failed because the account is not configured to 
carry out the requested action. 

909 

Invalid flag 

Transaction failed because the request included an invalid 
field/parameter. 

919 

All required argument not received 

Transaction failed because the request is missing a mandatory 
field/parameter. 

921 

Wrong MD5 encoding 

Transaction failed because the MD5 hash was not correct. 

Typically indicates that the password is incorrect. 


TransferTo Inc. - Cross-Border Mobile Payments 
© Copyright 2016 - Confidential 




























Airtime API Document 
Version No. 2.8.3 



TransferTo 


Code 

Text 

Description 

922 

Originating IP not allowed 

Transaction failed because the request originated from an IP 

that is not whitelisted for the account. 

923 

Key or MD5 value cannot be empty 

Request failed because Key or MD5 values are empty. 

925 

Key already used or invalid key val¬ 
ue 

Request failed because the key value included in the request 
was not unique than the previous key used. 

926 

Account not active. Please contact 

your Account Manager. 


995 

Account not found. Please enter 

and use a correct login. 


998 

System not available. Please retry 

later. 

Request failed due to technical issues. 

Please contact TransferTo Support Team for further investiga¬ 
tion. 

999 

Unknown error. 

To be escalated to the TransferTo Support Team for further in¬ 
vestigation. 
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10.0 Annexes 

10.1 Sample Code in JAVA for MD5 Generation 

This class generates the MD5 value in JAVA language. 

import java.security.MessageDigest; 

import java.security.NoSuchAlgorithmException; 

import java.util.GregorianCalendar; 

class HelloWorldApp { 

public static void main(String[] args) 

{ 

String md5_string = getKeyedDigest("your_login",''your_ token",''your_key"); 

System, out. println(md5_string); 

} 

public static String getKeyedDigest(String login, String token, String key) 

{ 

try { 

String temp = login + token + key; 

MessageDigest md5 = MessageDigest.getlnstance("MD5"); 
byte[] bytes = md5.digest(temp.getBytes()); 
return byteToHex(bytes); 

} catch(NoSuchAlgorithmExceptione) 

{ 

System, out. printlnfoops"); 

} 

return null; 

} 

public static String byteToHex(byte[] bits) 

{ 

if (bits == null) 

{ 

return null; 

} 

StringBuffer hex = new StringBuffer(bits.length * 2); 
for (int i = 0; i < bits.length; i++) 

{ 

if (((int) bits[i] & Oxff) < 0x10) 

{ 

hex.append("0"); 

} 

hex.append(lnteger.toString((int) bits[i] & Oxff, 16)); 

} 
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return hex.toString(); 

} 

} 


10.2 Sample Code in PHP 

https://shop.transferto.com/shop/v3/demo/api sample.php 

<?php 

//TransferTo 

//Sample code to send request to API 
//Version 1.03 
//7 th Feb 2013 

//TransferTo account credentials 
$login="your_login"; 

$token ="your_ token"; 

// MD5 calculation 
$key=time(); 

$md5=md5($login.$token.$key); 

//TransferTo Platform 

$url="https://airtime.transferto.com/cgi-bin/shop/topup"; 

//Test data 

$destination_msisdn="+628123456770"; 

?> 

Check Wallet: 

<form name="wallet" method="post" action="<?php echo $url;?>" > 

<input type="text" name="login" value="<?php echo $login?>" > 

<input type="hidden" name="key" value="<?php echo $key?>" > 

<input type="hidden" name="md5" value="<?php echo $md5?>" > 

<input type="hidden" name="action" value="check_wallet" > 

<input type="submit" value="submit" /> 

</form> 

Check a destination number or get products for a number: 

<form name="recipient" method="post" action="<?php echo $url ?>" > 

<input type="hidden" name="login" value="<?php echo $login ?>" > 

<input type="hidden" name="key" value="<?php echo $key ?>" > 

<input type="hidden" name="md5" value="<?php echo $md5 ?>" > 

<input type="text" name="destination_msisdn" value="<?php echo $destination_msisdn ?>" > 
<input type="hidden" name="action" value="msisdn_info" > 

<input type="submit" value="submit" /> 

</form> 
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Send a Topup: 

<form name="topup" method="post" action="<?php echo $url ?>" > 

<input type="hidden" name="login" value="<?php echo $login ?>" > 

<input type="hidden" name="key" value="<?php echo $key ?>" > 

<input type="hidden" name="md5" value="<?php echo $md5 ?>" > 

<input type="hidden" name="delivered_amount_info" value="l" > 

<input type="text" name="destination_msisdn" value="<?php echo $destination_msisdn ?>" > 
<input type="text" name="msisdn" value="<?php echo $msisdn ?>" > 

<input type="text" name="product" value="<?php echo $product ?>" > 

<input type="hidden" name="action" value="topup" > 

<input type="submit" value="submit" /> 

</form> 
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10.3 URL to retrieve operator logo images 

TransferTo API offers the possibility to retrieve operator logo images. 

It is quick and easy, you just need to know the operatorid. 

The URL is the following: https://operator-logo.transferto.com/logo-ID-SIZE.png 

• ID is the operatorid 

• SIZE is an integer from 1 (smallest) to 3 (biggest). 


Tigo Sample: 
Orange Sample: 
MTN Sample: 


https://operator-lopo.transferto.com/lopo-1529-l.pnp 

https://operator-loao.transferto.com/loao-1530-l.png 

https://operator-loao.transferto.com/loao-1526-l.png 
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10.4 Web Developers Samples 


orange 


OrangeTop-Up 

Top-up mobile phones with Orange 
Top-up to over 100 countries. 


ftobileRecharge 

Mobile Recharge 

With a mobile-friendly interface, 
send Top-ups quickly to over 100 
countries. 


topup.orange.com 


mobilerecharge.com 


PayPal 


Sprint 


PayPal 

France based customers only: Send 
a Top-up to any mobile phone on 
our network. 


Sprint 

Top-up prepaid wireless accounts 
for a wide variety of U.S carriers 
and international carriers in 33 
countries. 


paypal-mobilereload.com 


rn.transferto.com 
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PREPAID UNION® 

ft*** 

SENDLYfc 

Prepaid Union 

Top-up phones in 108 countries, no 
registration necessary. 24/7 support 

available on chat and mail. 

Sendly 

The most popular mobile top up 
app in the world. Available now for 

iPhone and Android. 

prepaidunion.com 

sendly.com 

Joxko 

beCHARGE 

X 

T r • n s ( «rt 


Joxko Transfers 

Instantly Top-up the mobile phone 
of your family or friend around the 

world. 

beCharge 

Top-up mobile phones directly 
without any extra cost, wherever 
they are with beCharge. 

joxko.com 

becharge.com 


UJorldRemit" 

Afriphone / 


Afriphone 

Afriphone enables instant mobile 
phone recharge in Africa. 

WorldRemit 

Recharge a mobile phone in over 

100 destinations and 300 mobile 

networks 

afri-phone.com 

worldremit.com 


TransferTo Inc. - Cross-Border Mobile Payments 
© Copyright 2016 - Confidential 



















Airtime API Document 
Version No. 2.8.3 



TransferTo 


10.5 Mobile Apps Developers Samples 





Red Pocket 

MOBILE 


Tigo Recargas Top Up 


Red Pocket Mobile Recharge 



Top Up Pro - Mobile Recharge 
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